home *** CD-ROM | disk | FTP | other *** search
/ IRIX 6.5 Complementary Applications 2004 February / SGI IRIX 6.5 Complementary Applications 2004 February.iso / dist / patchSG0004915.idb / usr / ToolTalk / man3 / tt_spec_move.z / tt_spec_move
Encoding:
Text File  |  2003-08-19  |  4.9 KB  |  132 lines
  1.  
  2.  
  3.  
  4. tttttttt____ssssppppeeeecccc____mmmmoooovvvveeee((((3333))))                                                tttttttt____ssssppppeeeecccc____mmmmoooovvvveeee((((3333))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      tt_spec_move - notify the ToolTalk service that an object has moved to a
  10.      different file
  11.  
  12. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.      ####iiiinnnncccclllluuuuddddeeee <<<<TTTTtttt////tttttttt____cccc....hhhh>>>>
  14.      cccchhhhaaaarrrr ****tttttttt____ssssppppeeeecccc____mmmmoooovvvveeee((((ccccoooonnnnsssstttt cccchhhhaaaarrrr ****_o_b_j_i_d,,,,
  15.                         ccccoooonnnnsssstttt cccchhhhaaaarrrr ****_n_e_w_f_i_l_e_p_a_t_h))));;;;
  16.  
  17. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  18.      The tttttttt____ssssppppeeeecccc____mmmmoooovvvveeee() function notifies the ToolTalk service that this
  19.      object has moved to a different file.
  20.  
  21.      The ToolTalk service returns a new objid for the object and leaves a
  22.      forwarding pointer from the old objid to the new one.
  23.  
  24.      If a new objid is not required (for example, because the new and old
  25.      files are in the same file system), tttttttt____ssssppppeeeecccc____mmmmoooovvvveeee() returns
  26.      TTTTTTTT____WWWWRRRRNNNN____SSSSAAAAMMMMEEEE____OOOOBBBBJJJJIIIIDDDD.
  27.  
  28.      The _o_b_j_i_d argument is the identifier of the object involved in this
  29.      operation.
  30.  
  31.      The _n_e_w_f_i_l_e_p_a_t_h argument is the new file name.
  32.  
  33. RRRREEEETTTTUUUURRRRNNNN VVVVAAAALLLLUUUUEEEE
  34.      Upon successful completion, the tttttttt____ssssppppeeeecccc____mmmmoooovvvveeee() function returns the new
  35.      unique identifier of the object involved in this operation.  The
  36.      application can use tttttttt____ppppttttrrrr____eeeerrrrrrrroooorrrr(3) to extract one of the following
  37.      TTTTtttt____ssssttttaaaattttuuuussss values from the returned pointer:
  38.  
  39.         TTTTTTTT____OOOOKKKK   The operation completed successfully.
  40.  
  41.         TTTTTTTT____EEEERRRRRRRR____DDDDBBBBAAAAVVVVAAAAIIIILLLL
  42.                 The ToolTalk service could not access the ToolTalk database
  43.                 needed for this operation.
  44.  
  45.         TTTTTTTT____EEEERRRRRRRR____DDDDBBBBEEEEXXXXIIIISSSSTTTT
  46.                 The ToolTalk service could not access the specified ToolTalk
  47.                 database in the expected place.
  48.  
  49.         TTTTTTTT____EEEERRRRRRRR____NNNNOOOOMMMMPPPP
  50.                 The ttttttttsssseeeessssssssiiiioooonnnn(1) process is not running and the ToolTalk
  51.                 service cannot restart it.
  52.  
  53.         TTTTTTTT____EEEERRRRRRRR____OOOOBBBBJJJJIIIIDDDD
  54.                 The _o_b_j_i_d passed to the ToolTalk service does not reference an
  55.                 existing object spec.
  56.  
  57.  
  58.  
  60.  
  61.  
  62.                                                                         PPPPaaaaggggeeee 1111
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69. tttttttt____ssssppppeeeecccc____mmmmoooovvvveeee((((3333))))                                                tttttttt____ssssppppeeeecccc____mmmmoooovvvveeee((((3333))))
  70.  
  71.  
  72.  
  73.         TTTTTTTT____EEEERRRRRRRR____PPPPAAAATTTTHHHH
  74.                 The specified pathname included an unsearchable directory.
  75.  
  76.         TTTTTTTT____WWWWRRRRNNNN____SSSSAAAAMMMMEEEE____OOOOBBBBJJJJIIIIDDDD
  77.                 A new _o_b_j_i_d is not required.
  78.  
  79. AAAAPPPPPPPPLLLLIIIICCCCAAAATTTTIIIIOOOONNNN UUUUSSSSAAAAGGGGEEEE
  80.      The application should use tttttttt____ffffrrrreeeeeeee(3) to free any data stored in the
  81.      address returned by the ToolTalk API.
  82.  
  83.      For efficiency and reliability, the application should replace any
  84.      references in the application to the old _o_b_j_i_d with references to the new
  85.      one.
  86.  
  87. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  88.      TTTTtttttttttttt____cccc(5), tttttttt____ppppttttrrrr____eeeerrrrrrrroooorrrr(3), tttttttt____ffffrrrreeeeeeee(3).
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.                                                                         PPPPaaaaggggeeee 2222
  129.  
  130.  
  131.  
  132.